Microsoft.ContainerService/managedClusters/agentPools 2023

您所在的位置:网站首页 fluent的reference value怎么设置 Microsoft.ContainerService/managedClusters/agentPools 2023

Microsoft.ContainerService/managedClusters/agentPools 2023

2023-05-28 12:14| 来源: 网络整理| 查看: 265

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

Microsoft.ContainerService managedClusters/agentPools 2023-03-01 项目 05/06/2023 最新 2023-03-02-preview 2023-03-01 2023-02-02-preview 2023-02-01 2023-01-02-preview 2023-01-01 2022-11-02-preview 2022-11-01 2022-10-02-preview 2022-09-02-preview 2022-09-01 2022-08-03-preview 2022-08-02-preview 2022-07-02-preview 2022-07-01 2022-06-02-preview 2022-06-01 2022-05-02-preview 2022-04-02-preview 2022-04-01 2022-03-02-preview 2022-03-01 2022-02-01 2022-01-02-preview 2022-01-01 2021-11-01-preview 2021-10-01 2021-09-01 2021-08-01 2021-07-01 2021-05-01 2021-03-01 2021-02-01 2020-12-01 2020-11-01 2020-09-01 Bicep 资源定义

可以使用面向以下操作部署 managedClusters/agentPools 资源类型:

资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表,请参阅 更改日志。

资源格式

若要创建 Microsoft.ContainerService/managedClusters/agentPools 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.ContainerService/managedClusters/agentPools@2023-03-01' = { name: 'string' parent: resourceSymbolicName properties: { availabilityZones: [ 'string' ] count: int creationData: { sourceResourceId: 'string' } enableAutoScaling: bool enableEncryptionAtHost: bool enableFIPS: bool enableNodePublicIP: bool enableUltraSSD: bool gpuInstanceProfile: 'string' hostGroupID: 'string' kubeletConfig: { allowedUnsafeSysctls: [ 'string' ] containerLogMaxFiles: int containerLogMaxSizeMB: int cpuCfsQuota: bool cpuCfsQuotaPeriod: 'string' cpuManagerPolicy: 'string' failSwapOn: bool imageGcHighThreshold: int imageGcLowThreshold: int podMaxPids: int topologyManagerPolicy: 'string' } kubeletDiskType: 'string' linuxOSConfig: { swapFileSizeMB: int sysctls: { fsAioMaxNr: int fsFileMax: int fsInotifyMaxUserWatches: int fsNrOpen: int kernelThreadsMax: int netCoreNetdevMaxBacklog: int netCoreOptmemMax: int netCoreRmemDefault: int netCoreRmemMax: int netCoreSomaxconn: int netCoreWmemDefault: int netCoreWmemMax: int netIpv4IpLocalPortRange: 'string' netIpv4NeighDefaultGcThresh1: int netIpv4NeighDefaultGcThresh2: int netIpv4NeighDefaultGcThresh3: int netIpv4TcpFinTimeout: int netIpv4TcpkeepaliveIntvl: int netIpv4TcpKeepaliveProbes: int netIpv4TcpKeepaliveTime: int netIpv4TcpMaxSynBacklog: int netIpv4TcpMaxTwBuckets: int netIpv4TcpTwReuse: bool netNetfilterNfConntrackBuckets: int netNetfilterNfConntrackMax: int vmMaxMapCount: int vmSwappiness: int vmVfsCachePressure: int } transparentHugePageDefrag: 'string' transparentHugePageEnabled: 'string' } maxCount: int maxPods: int minCount: int mode: 'string' nodeLabels: {} nodePublicIPPrefixID: 'string' nodeTaints: [ 'string' ] orchestratorVersion: 'string' osDiskSizeGB: int osDiskType: 'string' osSKU: 'string' osType: 'string' podSubnetID: 'string' powerState: { code: 'string' } proximityPlacementGroupID: 'string' scaleDownMode: 'string' scaleSetEvictionPolicy: 'string' scaleSetPriority: 'string' spotMaxPrice: int tags: {} type: 'string' upgradeSettings: { maxSurge: 'string' } vmSize: 'string' vnetSubnetID: 'string' workloadRuntime: 'string' } } 属性值 managedClusters/agentPools 名称 说明 值 name 资源名称

了解如何在 Bicep 中设置子资源的名称和类型。

字符串 (必需) 父级 (parent) 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源之外的子资源。

类型为:managedClusters 的资源的符号名称 properties 代理池的属性。 ManagedClusterAgentPoolProfileProperties ManagedClusterAgentPoolProfileProperties 名称 说明 值 availabilityZones 要用于节点的可用性区域列表。 仅当 AgentPoolType 属性为“VirtualMachineScaleSets”时,才能指定此项。 string[] count ) 托管 docker 容器 (VM 的代理数。 对于用户池,允许的值必须介于 0 到 1000 ((含) )范围内,系统池的) 范围为 1 到 1000 (( 含) )。 默认值为 1。 int creationData 如果将使用快照创建/升级节点池,则用于指定源快照 ID 的 CreationData。 CreationData enableAutoScaling 是否启用自动缩放程序 bool enableEncryptionAtHost 只有某些 VM 大小和某些 Azure 区域才支持此功能。 有关详细信息,请参阅:/azure/aks/enable-host-encryption bool enableFIPS 有关更多详细信息 ,请参阅添加已启用 FIPS 的节点池 。 bool enableNodePublicIP 某些方案可能要求节点池中的节点接收其自己的专用公共 IP 地址。 游戏工作负载就是一种常见方案,此时控制台需要直接连接到云虚拟机才能尽量减少画面跳跃。 有关详细信息,请参阅 为每个节点分配公共 IP。 默认值为 false。 bool enableUltraSSD 是否启用 UltraSSD bool gpuInstanceProfile GPUInstanceProfile 用于为受支持的 GPU VM SKU 指定 GPU MIG 实例配置文件。 “MIG1g”“MIG2g”“MIG3g”“MIG4g”“MIG7g” hostGroupID 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}。 有关详细信息,请参阅 Azure 专用主机。 字符串 kubeletConfig 代理池节点上的 Kubelet 配置。 KubeletConfig kubeletDiskType 确定 emptyDir 卷、容器运行时数据根和 Kubelet 临时存储的位置。 'OS'“Temporary” linuxOSConfig Linux 代理节点的 OS 配置。 LinuxOSConfig maxCount 自动缩放的最大节点数 int maxPods 可在节点上运行的最大 Pod 数。 int minCount 用于自动缩放的最小节点数 int mode 一个群集必须始终保持至少一个“系统”代理池。 有关代理池限制和最佳做法的其他信息,请参阅:/azure/aks/use-system-pools “System”“User” nodeLabels 要跨代理池中所有节点持久保存的节点标签。 对象 (object) nodePublicIPPrefixID 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 字符串 nodeTaints 在节点池创建和缩放期间添加到新节点的污点。 例如,key=value:NoSchedule。 string[] orchestratorVersion 支持修补程序版本 {major.minor.patch} (例如 1.20.13) 和 {major.minor} (例如 1.20) 。 指定 {major.minor} 后,将自动选择受支持的最新 GA 修补程序版本。 创建群集后,使用同一 {major.minor} 更新群集 (例如 1.14.x -} 1.14) ,即使有更新的修补程序版本可用,也不会触发升级。 最佳做法是将 AKS 群集中的所有节点池升级到相同的 Kubernetes 版本。 节点池版本的主要版本必须与控制平面相同。 节点池的次要版本必须在控制平面版本的两个次要版本范围内。 节点池版本不能大于控制平面版本。 有关详细信息 ,请参阅升级节点池。 字符串 osDiskSizeGB OS 磁盘大小(以 GB 为单位)用于指定主/代理池中每台计算机的磁盘大小。 如果指定 0,它将根据指定的 vmSize 应用默认 osDisk 大小。 int osDiskType 如果 VM 支持它,并且缓存磁盘大于请求的 OSDiskSizeGB,则默认值为“临时”。 否则,默认为“Managed”。 创建后可能不会更改。 有关详细信息 ,请参阅临时 OS。 'Ephemeral''Managed' osSKU 指定代理池使用的 OS SKU。 如果 OSType 为 Linux,则默认值为 Ubuntu。 当 Kubernetes = 1.25 时,默认值为 Windows 2022。 'CBLMariner''Ubuntu'“Windows2019”“Windows2022” osType 操作系统类型。 默认值为 Linux。 'Linux'“Windows” podSubnetID 如果省略,则会在节点子网上静态分配 Pod IP (有关) 的更多详细信息,请参阅 vnetSubnetID。 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 字符串 powerState 首次创建代理池时,它最初处于运行状态。 可以通过将此字段设置为“已停止”来停止代理池。 已停止的代理池会停止其所有 VM,并且不会产生计费费用。 仅当代理池处于“正在运行”且预配状态为“成功”时,才能停止该代理池 PowerState proximityPlacementGroupID 邻近放置组的 ID。 字符串 scaleDownMode 这也会影响群集自动缩放程序的行为。 如果未指定,则默认为 Delete。 “Deallocate”'Delete' scaleSetEvictionPolicy 除非 scaleSetPriority 为“Spot”,否则无法指定此项。 如果未指定,则默认值为“Delete”。 “Deallocate”“Delete” scaleSetPriority 虚拟机规模集优先级。 如果未指定,则默认值为“Regular”。 “常规”“Spot” spotMaxPrice 可能的值是大于零或 -1 的任何十进制值,表示愿意支付任何按需价格。 有关现成定价的更多详细信息,请参阅 现成 VM 定价 int 标记 要保留在代理池虚拟机规模集上的标记。 对象 (object) 类型 代理池的类型。 “AvailabilitySet”“VirtualMachineScaleSets” upgradeSettings 用于升级代理池的设置 AgentPoolUpgradeSettings vmSize VM 大小可用性因区域而异。 如果节点包含的计算资源不足 (内存、cpu 等) Pod 可能无法正确运行。 有关受限 VM 大小的更多详细信息,请参阅:/azure/aks/quotas-skus-regions 字符串 vnetSubnetID 如果未指定此项,则会生成并使用 VNET 和子网。 如果未指定 podSubnetID,则这适用于节点和 Pod,否则仅应用于节点。 其格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 字符串 workloadRuntime 确定节点可以运行的工作负荷类型。 “OCIContainer”“WasmWasi” CreationData 名称 说明 值 sourceResourceId 这是要用于创建目标对象的源对象的 ARM ID。 字符串 KubeletConfig 名称 说明 值 allowedUnsafeSysctls 允许的不安全 sysctls 或不安全 sysctl 模式列表 (以) 结尾 * 。 string[] containerLogMaxFiles 一个容器可以存在的最大容器日志文件数。 该数字必须为 2 ≥。 int containerLogMaxSizeMB 最大大小 (例如轮换容器日志文件前的 10Mi) 。 int cpuCfsQuota 默认值为 true。 bool cpuCfsQuotaPeriod 默认值为“100ms”。 有效值是具有可选小数和单位后缀的十进制数序列。 例如:“300ms”、“2h45m”。 支持的单位为“ns”、“us”、“ms”、“s”、“m”和“h”。 字符串 cpuManagerPolicy 默认值为“none”。 有关详细信息 ,请参阅 Kubernetes CPU 管理策略 。 允许的值为“none”和“static”。 字符串 failSwapOn 如果设置为 true,则如果在节点上启用了交换,则会导致 Kubelet 无法启动。 bool imageGcHighThreshold 如果要禁用映像垃圾回收,则设置为 100。 默认值为 85% int imageGcLowThreshold 此设置不能高于 imageGcHighThreshold。 默认值为 80% int podMaxPids 每个 Pod 的最大进程数。 int topologyManagerPolicy 有关详细信息,请参阅 Kubernetes 拓扑管理器。 默认值为“none”。 允许的值为“none”、“best-effort”、“restricted”和“single-numa-node”。 字符串 LinuxOSConfig 名称 说明 值 swapFileSizeMB 将在每个节点上创建的交换文件的大小(以 MB 为单位)。 int sysctls Linux 代理节点的 Sysctl 设置。 SysctlConfig transparentHugePageDefrag 有效值为“always”、“defer”、“defer+madvise”、“madvise”和“never”。 默认值为“madvise”。 有关详细信息,请参阅 透明巨页。 字符串 transparentHugePageEnabled 有效值为“always”、“madvise”和“never”。 默认值为“always”。 有关详细信息,请参阅 透明巨页。 字符串 SysctlConfig 名称 说明 值 fsAioMaxNr Sysctl 设置 fs.aio-max-nr。 int fsFileMax Sysctl setting fs.file-max. int fsInotifyMaxUserWatches Sysctl 设置fs.inotify.max_user_watches。 int fsNrOpen Sysctl 设置fs.nr_open。 int kernelThreadsMax Sysctl setting kernel.threads-max. int netCoreNetdevMaxBacklog Sysctl 设置net.core.netdev_max_backlog。 int netCoreOptmemMax Sysctl 设置net.core.optmem_max。 int netCoreRmemDefault Sysctl 设置net.core.rmem_default。 int netCoreRmemMax Sysctl 设置net.core.rmem_max。 int netCoreSomaxconn Sysctl setting net.core.somaxconn。 int netCoreWmemDefault Sysctl 设置net.core.wmem_default。 int netCoreWmemMax Sysctl 设置net.core.wmem_max。 int netIpv4IpLocalPortRange Sysctl 设置net.ipv4.ip_local_port_range。 字符串 netIpv4NeighDefaultGcThresh1 Sysctl 设置net.ipv4.neigh.default.gc_thresh1。 int netIpv4NeighDefaultGcThresh2 Sysctl 设置net.ipv4.neigh.default.gc_thresh2。 int netIpv4NeighDefaultGcThresh3 Sysctl 设置net.ipv4.neigh.default.gc_thresh3。 int netIpv4TcpFinTimeout Sysctl 设置net.ipv4.tcp_fin_timeout。 int netIpv4TcpkeepaliveIntvl Sysctl 设置net.ipv4.tcp_keepalive_intvl。 int netIpv4TcpKeepaliveProbes Sysctl 设置net.ipv4.tcp_keepalive_probes。 int netIpv4TcpKeepaliveTime Sysctl 设置net.ipv4.tcp_keepalive_time。 int netIpv4TcpMaxSynBacklog Sysctl 设置net.ipv4.tcp_max_syn_backlog。 int netIpv4TcpMaxTwBuckets Sysctl 设置net.ipv4.tcp_max_tw_buckets。 int netIpv4TcpTwReuse Sysctl 设置net.ipv4.tcp_tw_reuse。 bool netNetfilterNfConntrackBuckets Sysctl 设置net.netfilter.nf_conntrack_buckets。 int netNetfilterNfConntrackMax Sysctl 设置net.netfilter.nf_conntrack_max。 int vmMaxMapCount Sysctl 设置vm.max_map_count。 int vmSwappiness Sysctl 设置 vm.swappiness。 int vmVfsCachePressure Sysctl 设置vm.vfs_cache_pressure。 int PowerState 名称 说明 值 code 指示群集是正在运行还是已停止 “正在运行”'Stopped' AgentPoolUpgradeSettings 名称 说明 值 maxSurge 这可以设置为整数 ((例如“5”) )或百分比 (例如“50%”) 。 如果指定了百分比,则为升级时代理池总大小的百分比。 对于百分比,小数节点向上舍入。 如果未指定,则默认值为 1。 有关详细信息(包括最佳做法),请参阅:/azure/aks/upgrade-cluster#customize-node-surge-upgrade 字符串 快速入门模板

以下快速入门模板部署此资源类型。

模板 说明 为 Azure ML 部署 AKS 群集

此模板允许部署可附加到 Azure ML 的符合条目的 AKS 群集 ARM 模板资源定义

可以使用面向以下操作部署 managedClusters/agentPools 资源类型:

资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表,请参阅 更改日志。

资源格式

若要创建 Microsoft.ContainerService/managedClusters/agentPools 资源,请将以下 JSON 添加到模板。

{ "type": "Microsoft.ContainerService/managedClusters/agentPools", "apiVersion": "2023-03-01", "name": "string", "properties": { "availabilityZones": [ "string" ], "count": "int", "creationData": { "sourceResourceId": "string" }, "enableAutoScaling": "bool", "enableEncryptionAtHost": "bool", "enableFIPS": "bool", "enableNodePublicIP": "bool", "enableUltraSSD": "bool", "gpuInstanceProfile": "string", "hostGroupID": "string", "kubeletConfig": { "allowedUnsafeSysctls": [ "string" ], "containerLogMaxFiles": "int", "containerLogMaxSizeMB": "int", "cpuCfsQuota": "bool", "cpuCfsQuotaPeriod": "string", "cpuManagerPolicy": "string", "failSwapOn": "bool", "imageGcHighThreshold": "int", "imageGcLowThreshold": "int", "podMaxPids": "int", "topologyManagerPolicy": "string" }, "kubeletDiskType": "string", "linuxOSConfig": { "swapFileSizeMB": "int", "sysctls": { "fsAioMaxNr": "int", "fsFileMax": "int", "fsInotifyMaxUserWatches": "int", "fsNrOpen": "int", "kernelThreadsMax": "int", "netCoreNetdevMaxBacklog": "int", "netCoreOptmemMax": "int", "netCoreRmemDefault": "int", "netCoreRmemMax": "int", "netCoreSomaxconn": "int", "netCoreWmemDefault": "int", "netCoreWmemMax": "int", "netIpv4IpLocalPortRange": "string", "netIpv4NeighDefaultGcThresh1": "int", "netIpv4NeighDefaultGcThresh2": "int", "netIpv4NeighDefaultGcThresh3": "int", "netIpv4TcpFinTimeout": "int", "netIpv4TcpkeepaliveIntvl": "int", "netIpv4TcpKeepaliveProbes": "int", "netIpv4TcpKeepaliveTime": "int", "netIpv4TcpMaxSynBacklog": "int", "netIpv4TcpMaxTwBuckets": "int", "netIpv4TcpTwReuse": "bool", "netNetfilterNfConntrackBuckets": "int", "netNetfilterNfConntrackMax": "int", "vmMaxMapCount": "int", "vmSwappiness": "int", "vmVfsCachePressure": "int" }, "transparentHugePageDefrag": "string", "transparentHugePageEnabled": "string" }, "maxCount": "int", "maxPods": "int", "minCount": "int", "mode": "string", "nodeLabels": {}, "nodePublicIPPrefixID": "string", "nodeTaints": [ "string" ], "orchestratorVersion": "string", "osDiskSizeGB": "int", "osDiskType": "string", "osSKU": "string", "osType": "string", "podSubnetID": "string", "powerState": { "code": "string" }, "proximityPlacementGroupID": "string", "scaleDownMode": "string", "scaleSetEvictionPolicy": "string", "scaleSetPriority": "string", "spotMaxPrice": "int", "tags": {}, "type": "string", "upgradeSettings": { "maxSurge": "string" }, "vmSize": "string", "vnetSubnetID": "string", "workloadRuntime": "string" } } 属性值 managedClusters/agentPools 名称 说明 Value type 资源类型 'Microsoft.ContainerService/managedClusters/agentPools' apiVersion 资源 API 版本 '2023-03-01' name 资源名称

了解如何在 JSON ARM 模板中设置子资源的名称和类型。

字符串 (必需) properties 代理池的属性。 ManagedClusterAgentPoolProfileProperties ManagedClusterAgentPoolProfileProperties 名称 说明 值 availabilityZones 要用于节点的可用性区域列表。 仅当 AgentPoolType 属性为“VirtualMachineScaleSets”时,才能指定此项。 string[] count ) 托管 docker 容器 (VM 的代理数。 对于用户池,允许的值必须介于 0 到 1000 ((含) )范围内,系统池的) 范围为 1 到 1000 (( 含) )。 默认值为 1。 int creationData 如果将使用快照创建/升级节点池,则用于指定源快照 ID 的 CreationData。 CreationData enableAutoScaling 是否启用自动缩放程序 bool enableEncryptionAtHost 只有某些 VM 大小和某些 Azure 区域才支持此功能。 有关详细信息,请参阅:/azure/aks/enable-host-encryption bool enableFIPS 有关更多详细信息 ,请参阅添加已启用 FIPS 的节点池 。 bool enableNodePublicIP 某些方案可能要求节点池中的节点接收其自己的专用公共 IP 地址。 游戏工作负载就是一种常见方案,此时控制台需要直接连接到云虚拟机才能尽量减少画面跳跃。 有关详细信息,请参阅 为每个节点分配公共 IP。 默认值为 false。 bool enableUltraSSD 是否启用 UltraSSD bool gpuInstanceProfile GPUInstanceProfile 用于为受支持的 GPU VM SKU 指定 GPU MIG 实例配置文件。 “MIG1g”“MIG2g”“MIG3g”“MIG4g”“MIG7g” hostGroupID 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}。 有关详细信息,请参阅 Azure 专用主机。 字符串 kubeletConfig 代理池节点上的 Kubelet 配置。 KubeletConfig kubeletDiskType 确定 emptyDir 卷、容器运行时数据根和 Kubelet 临时存储的位置。 'OS'“Temporary” linuxOSConfig Linux 代理节点的 OS 配置。 LinuxOSConfig maxCount 自动缩放的最大节点数 int maxPods 可在节点上运行的最大 Pod 数。 int minCount 用于自动缩放的最小节点数 int mode 一个群集必须始终保持至少一个“系统”代理池。 有关代理池限制和最佳做法的其他信息,请参阅:/azure/aks/use-system-pools “System”“User” nodeLabels 要跨代理池中所有节点持久保存的节点标签。 对象 (object) nodePublicIPPrefixID 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 字符串 nodeTaints 在节点池创建和缩放期间添加到新节点的污点。 例如,key=value:NoSchedule。 string[] orchestratorVersion 支持修补程序版本 {major.minor.patch} (例如 1.20.13) 和 {major.minor} (例如 1.20) 。 指定 {major.minor} 后,将自动选择受支持的最新 GA 修补程序版本。 创建群集后,使用同一 {major.minor} 更新群集 (例如 1.14.x -} 1.14) ,即使有更新的修补程序版本可用,也不会触发升级。 最佳做法是将 AKS 群集中的所有节点池升级到相同的 Kubernetes 版本。 节点池版本的主要版本必须与控制平面相同。 节点池的次要版本必须在控制平面版本的两个次要版本范围内。 节点池版本不能大于控制平面版本。 有关详细信息 ,请参阅升级节点池。 字符串 osDiskSizeGB OS 磁盘大小(以 GB 为单位)用于指定主/代理池中每台计算机的磁盘大小。 如果指定 0,它将根据指定的 vmSize 应用默认 osDisk 大小。 int osDiskType 如果 VM 支持它,并且缓存磁盘大于请求的 OSDiskSizeGB,则默认值为“临时”。 否则,默认为“Managed”。 创建后可能不会更改。 有关详细信息 ,请参阅临时 OS。 'Ephemeral''Managed' osSKU 指定代理池使用的 OS SKU。 如果 OSType 为 Linux,则默认值为 Ubuntu。 当 Kubernetes = 1.25 时,默认值为 Windows 2022。 'CBLMariner''Ubuntu'“Windows2019”“Windows2022” osType 操作系统类型。 默认值为 Linux。 'Linux'“Windows” podSubnetID 如果省略,则会在节点子网上静态分配 Pod IP (有关) 的更多详细信息,请参阅 vnetSubnetID。 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 字符串 powerState 首次创建代理池时,它最初处于运行状态。 可以通过将此字段设置为“已停止”来停止代理池。 已停止的代理池会停止其所有 VM,并且不会产生计费费用。 仅当代理池处于“正在运行”且预配状态为“成功”时,才能停止该代理池 PowerState proximityPlacementGroupID 邻近放置组的 ID。 字符串 scaleDownMode 这也会影响群集自动缩放程序的行为。 如果未指定,则默认为 Delete。 “Deallocate”'Delete' scaleSetEvictionPolicy 除非 scaleSetPriority 为“Spot”,否则无法指定此项。 如果未指定,则默认值为“Delete”。 “Deallocate”'Delete' scaleSetPriority 虚拟机规模集优先级。 如果未指定,则默认值为“Regular”。 'Regular'“Spot” spotMaxPrice 可能的值是大于零或 -1 的任何十进制值,表示愿意支付任何按需价格。 有关现成定价的更多详细信息,请参阅 现成 VM 定价 int 标记 要保留在代理池虚拟机规模集上的标记。 对象 (object) 类型 代理池的类型。 “AvailabilitySet”“VirtualMachineScaleSets” upgradeSettings 用于升级代理池的设置 AgentPoolUpgradeSettings vmSize VM 大小可用性因区域而异。 如果节点包含的计算资源不足 (内存、cpu 等) Pod 可能无法正确运行。 有关受限 VM 大小的更多详细信息,请参阅:/azure/aks/quotas-skus-regions 字符串 vnetSubnetID 如果未指定此项,则会生成并使用 VNET 和子网。 如果未指定 podSubnetID,则这适用于节点和 Pod,否则仅应用于节点。 其格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 字符串 workloadRuntime 确定节点可以运行的工作负荷类型。 “OCIContainer”“WasmWasi” CreationData 名称 说明 值 sourceResourceId 这是要用于创建目标对象的源对象的 ARM ID。 字符串 KubeletConfig 名称 说明 值 allowedUnsafeSysctls 允许的不安全 sysctls 或不安全 sysctl 模式列表 (以) 结尾 * 。 string[] containerLogMaxFiles 一个容器可以存在的最大容器日志文件数。 该数字必须为 2 ≥。 int containerLogMaxSizeMB 最大大小 (例如轮换容器日志文件前的 10Mi) 。 int cpuCfsQuota 默认值为 true。 bool cpuCfsQuotaPeriod 默认值为“100ms”。 有效值是具有可选小数和单位后缀的十进制数序列。 例如:“300ms”、“2h45m”。 支持的单位为“ns”、“us”、“ms”、“s”、“m”和“h”。 字符串 cpuManagerPolicy 默认值为“none”。 有关详细信息 ,请参阅 Kubernetes CPU 管理策略 。 允许的值为“none”和“static”。 字符串 failSwapOn 如果设置为 true,则如果在节点上启用了交换,则会导致 Kubelet 无法启动。 bool imageGcHighThreshold 如果要禁用映像垃圾回收,则设置为 100。 默认值为 85% int imageGcLowThreshold 此设置不能高于 imageGcHighThreshold。 默认值为 80% int podMaxPids 每个 Pod 的最大进程数。 int topologyManagerPolicy 有关详细信息,请参阅 Kubernetes 拓扑管理器。 默认值为“none”。 允许的值为“none”、“best-effort”、“restricted”和“single-numa-node”。 字符串 LinuxOSConfig 名称 说明 值 swapFileSizeMB 将在每个节点上创建的交换文件的大小(以 MB 为单位)。 int sysctls Linux 代理节点的 Sysctl 设置。 SysctlConfig transparentHugePageDefrag 有效值为“always”、“defer”、“defer+madvise”、“madvise”和“never”。 默认值为“madvise”。 有关详细信息,请参阅 透明巨页。 字符串 transparentHugePageEnabled 有效值为“always”、“madvise”和“never”。 默认值为“always”。 有关详细信息,请参阅 透明巨页。 字符串 SysctlConfig 名称 说明 值 fsAioMaxNr Sysctl 设置 fs.aio-max-nr。 int fsFileMax Sysctl 设置 fs.file-max。 int fsInotifyMaxUserWatches Sysctl 设置fs.inotify.max_user_watches。 int fsNrOpen Sysctl 设置fs.nr_open。 int kernelThreadsMax Sysctl 设置 kernel.threads-max。 int netCoreNetdevMaxBacklog Sysctl 设置net.core.netdev_max_backlog。 int netCoreOptmemMax Sysctl 设置net.core.optmem_max。 int netCoreRmemDefault Sysctl 设置net.core.rmem_default。 int netCoreRmemMax Sysctl 设置net.core.rmem_max。 int netCoreSomaxconn Sysctl 设置 net.core.somaxconn。 int netCoreWmemDefault Sysctl 设置net.core.wmem_default。 int netCoreWmemMax Sysctl 设置net.core.wmem_max。 int netIpv4IpLocalPortRange Sysctl 设置net.ipv4.ip_local_port_range。 字符串 netIpv4NeighDefaultGcThresh1 Sysctl 设置net.ipv4.neigh.default.gc_thresh1。 int netIpv4NeighDefaultGcThresh2 Sysctl 设置net.ipv4.neigh.default.gc_thresh2。 int netIpv4NeighDefaultGcThresh3 Sysctl 设置net.ipv4.neigh.default.gc_thresh3。 int netIpv4TcpFinTimeout Sysctl 设置net.ipv4.tcp_fin_timeout。 int netIpv4TcpkeepaliveIntvl Sysctl 设置net.ipv4.tcp_keepalive_intvl。 int netIpv4TcpKeepaliveProbes Sysctl 设置net.ipv4.tcp_keepalive_probes。 int netIpv4TcpKeepaliveTime Sysctl 设置net.ipv4.tcp_keepalive_time。 int netIpv4TcpMaxSynBacklog Sysctl 设置net.ipv4.tcp_max_syn_backlog。 int netIpv4TcpMaxTwBuckets Sysctl 设置net.ipv4.tcp_max_tw_buckets。 int netIpv4TcpTwReuse Sysctl 设置net.ipv4.tcp_tw_reuse。 bool netNetfilterNfConntrackBuckets Sysctl 设置net.netfilter.nf_conntrack_buckets。 int netNetfilterNfConntrackMax Sysctl 设置net.netfilter.nf_conntrack_max。 int vmMaxMapCount Sysctl 设置vm.max_map_count。 int vmSwappiness Sysctl 设置 vm.swappiness。 int vmVfsCachePressure Sysctl 设置vm.vfs_cache_pressure。 int PowerState 名称 说明 值 code 指示群集是正在运行还是已停止 “正在运行”“已停止” AgentPoolUpgradeSettings 名称 说明 值 maxSurge 这可以设置为整数 (例如“5”) 或百分比 (例如“50%”) 。 如果指定了百分比,则表示升级时代理池总大小的百分比。 对于百分比,将小数点节点向上舍入。 如果未指定,则默认值为 1。 有关详细信息(包括最佳做法),请参阅:/azure/aks/upgrade-cluster#customize-node-surge-upgrade 字符串 快速入门模板

以下快速入门模板部署此资源类型。

模板 说明 为 Azure ML 部署 AKS 群集

此模板允许部署可附加到 Azure ML 的符合条目的 AKS 群集 Terraform (AzAPI 提供程序) 资源定义

可以使用面向以下操作部署 managedClusters/agentPools 资源类型:

资源组

有关每个 API 版本中已更改属性的列表,请参阅 更改日志。

资源格式

若要创建 Microsoft.ContainerService/managedClusters/agentPools 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" { type = "Microsoft.ContainerService/managedClusters/agentPools@2023-03-01" name = "string" parent_id = "string" body = jsonencode({ properties = { availabilityZones = [ "string" ] count = int creationData = { sourceResourceId = "string" } enableAutoScaling = bool enableEncryptionAtHost = bool enableFIPS = bool enableNodePublicIP = bool enableUltraSSD = bool gpuInstanceProfile = "string" hostGroupID = "string" kubeletConfig = { allowedUnsafeSysctls = [ "string" ] containerLogMaxFiles = int containerLogMaxSizeMB = int cpuCfsQuota = bool cpuCfsQuotaPeriod = "string" cpuManagerPolicy = "string" failSwapOn = bool imageGcHighThreshold = int imageGcLowThreshold = int podMaxPids = int topologyManagerPolicy = "string" } kubeletDiskType = "string" linuxOSConfig = { swapFileSizeMB = int sysctls = { fsAioMaxNr = int fsFileMax = int fsInotifyMaxUserWatches = int fsNrOpen = int kernelThreadsMax = int netCoreNetdevMaxBacklog = int netCoreOptmemMax = int netCoreRmemDefault = int netCoreRmemMax = int netCoreSomaxconn = int netCoreWmemDefault = int netCoreWmemMax = int netIpv4IpLocalPortRange = "string" netIpv4NeighDefaultGcThresh1 = int netIpv4NeighDefaultGcThresh2 = int netIpv4NeighDefaultGcThresh3 = int netIpv4TcpFinTimeout = int netIpv4TcpkeepaliveIntvl = int netIpv4TcpKeepaliveProbes = int netIpv4TcpKeepaliveTime = int netIpv4TcpMaxSynBacklog = int netIpv4TcpMaxTwBuckets = int netIpv4TcpTwReuse = bool netNetfilterNfConntrackBuckets = int netNetfilterNfConntrackMax = int vmMaxMapCount = int vmSwappiness = int vmVfsCachePressure = int } transparentHugePageDefrag = "string" transparentHugePageEnabled = "string" } maxCount = int maxPods = int minCount = int mode = "string" nodeLabels = {} nodePublicIPPrefixID = "string" nodeTaints = [ "string" ] orchestratorVersion = "string" osDiskSizeGB = int osDiskType = "string" osSKU = "string" osType = "string" podSubnetID = "string" powerState = { code = "string" } proximityPlacementGroupID = "string" scaleDownMode = "string" scaleSetEvictionPolicy = "string" scaleSetPriority = "string" spotMaxPrice = int tags = {} type = "string" upgradeSettings = { maxSurge = "string" } vmSize = "string" vnetSubnetID = "string" workloadRuntime = "string" } }) } 属性值 managedClusters/agentPools 名称 说明 Value type 资源类型 “Microsoft.ContainerService/managedClusters/agentPools@2023-03-01” name 资源名称 字符串 (必需) parent_id 此资源的父资源的 ID。 类型为:managedClusters 的资源的 ID properties 代理池的属性。 ManagedClusterAgentPoolProfileProperties ManagedClusterAgentPoolProfileProperties 名称 说明 值 availabilityZones 要用于节点的可用性区域列表。 仅当 AgentPoolType 属性为“VirtualMachineScaleSets”时,才能指定此项。 string[] count ) 托管 docker 容器 (VM 的代理数。 对于用户池,允许的值必须介于 0 到 1000 ((含) )范围内,系统池的) 范围为 1 到 1000 (( 含) )。 默认值为 1。 int creationData 如果将使用快照创建/升级节点池,则用于指定源快照 ID 的 CreationData。 CreationData enableAutoScaling 是否启用自动缩放程序 bool enableEncryptionAtHost 只有某些 VM 大小和某些 Azure 区域才支持此功能。 有关详细信息,请参阅:/azure/aks/enable-host-encryption bool enableFIPS 有关更多详细信息 ,请参阅添加已启用 FIPS 的节点池 。 bool enableNodePublicIP 某些方案可能要求节点池中的节点接收其自己的专用公共 IP 地址。 游戏工作负载就是一种常见方案,此时控制台需要直接连接到云虚拟机才能尽量减少画面跳跃。 有关详细信息,请参阅 为每个节点分配公共 IP。 默认值为 false。 bool enableUltraSSD 是否启用 UltraSSD bool gpuInstanceProfile GPUInstanceProfile 用于为受支持的 GPU VM SKU 指定 GPU MIG 实例配置文件。 “MIG1g”“MIG2g”“MIG3g”“MIG4g”“MIG7g” hostGroupID 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}。 有关详细信息,请参阅 Azure 专用主机。 字符串 kubeletConfig 代理池节点上的 Kubelet 配置。 KubeletConfig kubeletDiskType 确定 emptyDir 卷、容器运行时数据根和 Kubelet 临时存储的位置。 “OS”“Temporary” linuxOSConfig Linux 代理节点的 OS 配置。 LinuxOSConfig maxCount 自动缩放的最大节点数 int maxPods 可在节点上运行的最大 Pod 数。 int minCount 用于自动缩放的最小节点数 int mode 一个群集必须始终保持至少一个“系统”代理池。 有关代理池限制和最佳做法的其他信息,请参阅:/azure/aks/use-system-pools “System”“User” nodeLabels 要跨代理池中所有节点持久保存的节点标签。 对象 (object) nodePublicIPPrefixID 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} 字符串 nodeTaints 在节点池创建和缩放期间添加到新节点的污点。 例如,key=value:NoSchedule。 string[] orchestratorVersion 支持修补程序版本 {major.minor.patch} (例如 1.20.13) 和 {major.minor} (例如 1.20) 。 指定 {major.minor} 后,将自动选择受支持的最新 GA 修补程序版本。 创建群集后,使用同一 {major.minor} 更新群集 (例如 1.14.x -} 1.14) ,即使有更新的修补程序版本可用,也不会触发升级。 最佳做法是将 AKS 群集中的所有节点池升级到相同的 Kubernetes 版本。 节点池版本的主要版本必须与控制平面相同。 节点池的次要版本必须在控制平面版本的两个次要版本范围内。 节点池版本不能大于控制平面版本。 有关详细信息 ,请参阅升级节点池。 字符串 osDiskSizeGB OS 磁盘大小(以 GB 为单位)用于指定主/代理池中每台计算机的磁盘大小。 如果指定 0,它将根据指定的 vmSize 应用默认 osDisk 大小。 int osDiskType 如果 VM 支持它,并且缓存磁盘大于请求的 OSDiskSizeGB,则默认值为“临时”。 否则,默认为“Managed”。 创建后可能不会更改。 有关详细信息 ,请参阅临时 OS。 “临时”“Managed” osSKU 指定代理池使用的 OS SKU。 如果 OSType 为 Linux,则默认值为 Ubuntu。 当 Kubernetes = 1.25 时,默认值为 Windows 2022。 “CBLMariner”“Ubuntu”“Windows2019”“Windows2022” osType 操作系统类型。 默认值为 Linux。 “Linux”“Windows” podSubnetID 如果省略,则会在节点子网上静态分配 Pod IP (有关) 的更多详细信息,请参阅 vnetSubnetID。 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 字符串 powerState 首次创建代理池时,它最初处于运行状态。 可以通过将此字段设置为“已停止”来停止代理池。 已停止的代理池会停止其所有 VM,并且不会产生计费费用。 仅当代理池处于“正在运行”且预配状态为“成功”时,才能停止该代理池 PowerState proximityPlacementGroupID 邻近放置组的 ID。 字符串 scaleDownMode 这也会影响群集自动缩放程序的行为。 如果未指定,则默认为 Delete。 “解除分配”“Delete” scaleSetEvictionPolicy 除非 scaleSetPriority 为“Spot”,否则无法指定此项。 如果未指定,则默认值为“Delete”。 “解除分配”“Delete” scaleSetPriority 虚拟机规模集优先级。 如果未指定,则默认值为“Regular”。 “Regular”“Spot” spotMaxPrice 可能的值是大于零或 -1 的任何十进制值,表示愿意支付任何按需价格。 有关现成定价的更多详细信息,请参阅 现成 VM 定价 int 标记 要保留在代理池虚拟机规模集上的标记。 对象 (object) 类型 代理池的类型。 “AvailabilitySet”“VirtualMachineScaleSets” upgradeSettings 用于升级代理池的设置 AgentPoolUpgradeSettings vmSize VM 大小可用性因区域而异。 如果节点包含的计算资源 (内存、CPU 等) Pod 可能无法正常运行。 有关受限 VM 大小的更多详细信息,请参阅:/azure/aks/quotas-skus-regions 字符串 vnetSubnetID 如果未指定,将生成并使用 VNET 和子网。 如果未指定 podSubnetID,则这适用于节点和 Pod,否则仅应用于节点。 此格式为:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} 字符串 workloadRuntime 确定节点可以运行的工作负荷类型。 “OCIContainer”“WasmWasi” CreationData 名称 说明 值 sourceResourceId 这是要用于创建目标对象的源对象的 ARM ID。 字符串 KubeletConfig 名称 说明 值 allowedUnsafeSysctls 允许的不安全 sysctls 或不安全 sysctl 模式列表 (以) 结尾 * 。 string[] containerLogMaxFiles 一个容器可以存在的最大容器日志文件数。 该数字必须为 2 ≥。 int containerLogMaxSizeMB 最大大小 (例如轮换容器日志文件前的 10Mi) 。 int cpuCfsQuota 默认值为 true。 bool cpuCfsQuotaPeriod 默认值为“100ms”。 有效值是具有可选小数和单位后缀的十进制数序列。 例如:“300ms”、“2h45m”。 支持的单位为“ns”、“us”、“ms”、“s”、“m”和“h”。 字符串 cpuManagerPolicy 默认值为“none”。 有关详细信息 ,请参阅 Kubernetes CPU 管理策略 。 允许的值为“none”和“static”。 字符串 failSwapOn 如果设置为 true,则如果在节点上启用了交换,则会导致 Kubelet 无法启动。 bool imageGcHighThreshold 如果要禁用映像垃圾回收,则设置为 100。 默认值为 85% int imageGcLowThreshold 此设置不能高于 imageGcHighThreshold。 默认值为 80% int podMaxPids 每个 Pod 的最大进程数。 int topologyManagerPolicy 有关详细信息,请参阅 Kubernetes 拓扑管理器。 默认值为“none”。 允许的值为“none”、“best-effort”、“restricted”和“single-numa-node”。 字符串 LinuxOSConfig 名称 说明 值 swapFileSizeMB 将在每个节点上创建的交换文件的大小(以 MB 为单位)。 int sysctls Linux 代理节点的 Sysctl 设置。 SysctlConfig transparentHugePageDefrag 有效值为“always”、“defer”、“defer+madvise”、“madvise”和“never”。 默认值为“madvise”。 有关详细信息,请参阅 透明巨页。 字符串 transparentHugePageEnabled 有效值为“always”、“madvise”和“never”。 默认值为“always”。 有关详细信息,请参阅 透明巨页。 字符串 SysctlConfig 名称 说明 值 fsAioMaxNr Sysctl 设置 fs.aio-max-nr。 int fsFileMax Sysctl 设置 fs.file-max。 int fsInotifyMaxUserWatches Sysctl 设置fs.inotify.max_user_watches。 int fsNrOpen Sysctl 设置fs.nr_open。 int kernelThreadsMax Sysctl 设置 kernel.threads-max。 int netCoreNetdevMaxBacklog Sysctl 设置net.core.netdev_max_backlog。 int netCoreOptmemMax Sysctl 设置net.core.optmem_max。 int netCoreRmemDefault Sysctl 设置net.core.rmem_default。 int netCoreRmemMax Sysctl 设置net.core.rmem_max。 int netCoreSomaxconn Sysctl setting net.core.somaxconn。 int netCoreWmemDefault Sysctl 设置net.core.wmem_default。 int netCoreWmemMax Sysctl 设置net.core.wmem_max。 int netIpv4IpLocalPortRange Sysctl 设置net.ipv4.ip_local_port_range。 字符串 netIpv4NeighDefaultGcThresh1 Sysctl 设置net.ipv4.neigh.default.gc_thresh1。 int netIpv4NeighDefaultGcThresh2 Sysctl 设置net.ipv4.neigh.default.gc_thresh2。 int netIpv4NeighDefaultGcThresh3 Sysctl 设置net.ipv4.neigh.default.gc_thresh3。 int netIpv4TcpFinTimeout Sysctl 设置net.ipv4.tcp_fin_timeout。 int netIpv4TcpkeepaliveIntvl Sysctl 设置net.ipv4.tcp_keepalive_intvl。 int netIpv4TcpKeepaliveProbes Sysctl 设置net.ipv4.tcp_keepalive_probes。 int netIpv4TcpKeepaliveTime Sysctl 设置net.ipv4.tcp_keepalive_time。 int netIpv4TcpMaxSynBacklog Sysctl 设置net.ipv4.tcp_max_syn_backlog。 int netIpv4TcpMaxTwBuckets Sysctl 设置net.ipv4.tcp_max_tw_buckets。 int netIpv4TcpTwReuse Sysctl 设置net.ipv4.tcp_tw_reuse。 bool netNetfilterNfConntrackBuckets Sysctl 设置net.netfilter.nf_conntrack_buckets。 int netNetfilterNfConntrackMax Sysctl 设置net.netfilter.nf_conntrack_max。 int vmMaxMapCount Sysctl 设置vm.max_map_count。 int vmSwappiness Sysctl 设置 vm.swappiness。 int vmVfsCachePressure Sysctl 设置vm.vfs_cache_pressure。 int PowerState 名称 说明 值 code 指示群集是正在运行还是已停止 “正在运行”“Stopped” AgentPoolUpgradeSettings 名称 说明 值 maxSurge 这可以设置为整数 ((例如“5”) )或百分比 (例如“50%”) 。 如果指定了百分比,则为升级时代理池总大小的百分比。 对于百分比,小数节点向上舍入。 如果未指定,则默认值为 1。 有关详细信息(包括最佳做法),请参阅:/azure/aks/upgrade-cluster#customize-node-surge-upgrade 字符串


【本文地址】


今日新闻


推荐新闻


CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3